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CROSS REFERENCE: 0374-4353-0-444-700 
DISCLOSURE TEXT: 

Disclosed is the methods used by Common Service Processor (CSP) , Hardware System 
Console (HSC) , and System Firmware Partition Manager (PM) for the management, 
instantiation, and termination of logical partitions in a logical partitioned ( LPAR ) 
system. In the logically partitionable system, the HSC is responsible to manage the 
assignments of system resources to all available logical partitions supported by the 
system. These assignments are saved in several tables in NVRAM of the system. The 
CSP provides a communication link whereby the HSC can access NVRAM to maintain and 
update these tables. On the other hand, the PM acts upon requests from the HSC to 
instantiate logical partitions by satisfying and allocating partitions ' resources 
assigned and indicated in these tables. The PM also, reclaims resources and cleans up 
the partitions when they terminate and cease to run. .As. a result of, the 
instant iations_ and terminations of partitions, the PM will directly update these 
same tables in NVRAM for the information related to partition state-status, 
processor state, etc.. Because of multiple writers to these tables, it is mandatory 
that these tables must be updated timely and correctly. Once the data structures of 
the tables are defined, the disclosed methods require that the designer of these 
tables to clearly identify the ownership of every field of the tables. The owner of 
a field can write to the field. However, all parties can read any field of the 
tables. Since some fields are used by the HSC and the PM at different times to 
perform the acknowledgment dialog, the ownership may be switched based on content of 
the fields. For the discussion, the entries of the processor table, I/O slot table, 
and partition table are shown below in their C code structures. Note that the owner 
(has write access to the field) is listed after the field description. Only a couple 
of fields can be written by multiple writers and that is shown as 0WNER1 / OWNER2 
(i.e. HSC/PM) . typedef struct { char lpar id; /* Logical Partition ID. HSC */ char 
status; /* Processor Status. CSP */ char state; /* Processor State. PM */ char 
proc_pir; /* Processor PIR number. CSP */ char phys_loc [32 ] ; /* Physical Location 
Code. CSP */ char lpar reset vector; /* Hypervisior reset vector. CSP */ char 
unused [2]; /* Reserved. CSP */ } LPAR PROC; typedef struct { char lpar id; /* 
Logical Partition ID. HSC */ char status; /* Slot status. CSP */ char state; /* Slot 
state. PM */ char phb_num; /* PHB number. PM */ char dev_id[4]; /* Device Id. PM */ 
char slot_phys_loc [7] ; /* Physical Location Code. PM */ char slot_num; /* Slot 
number. PM */ char PCI__class [3] ; /* PCI class code. PM */ char flag3; /* Reserved. 
CSP */ } LPAR 10 SLOT; typedef struct { char lpar id; /* Logical Partition ID. HSC 
*/ char cmd_state; /* Partition command state. PM */ char cmd; /* Current command. 
Cleared after consumed. HSC/PM */ /* CSP writes iff cmd_state = READY or ERROR */ /* 
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Partition manager writes iff cmd_state = Booting */ char cmd_last; /* Last command 
issued by HSC. CSP */ char err_code; /* Error code, valid when cmd status is set to 
ERROR. HSC/PM */ /* must be cleared after ERROR state before the Partition */ /* 
manager will accept any commands. */ char slot_avail; /* Slot available on this R/S 
/ 6000 model. CSP */ char lpar slot def; /* HSC partition definition state. HSC */ 
char service_auth; /* service authority - flash etc. HSC */ char lpar name [32] ; /* 
Name of partition. 

HSC */ int mem_size; /* Amount of memory assigned this partition in 1 MB units. HSC 
*/ int page_tbl_size; /* Page table size in 1 MB units. PM */ } LPAR CMD STATUS; 
J These entries are initialized to the default values of the fields by the CSP. 
Subsequently, the HSC can modify the fields belonging to the HSC to begin the 
configuration of each partition (i . e . assign processor resources and I/O slot 
resources to each partition) . When the PM comes up, the PM will update the fields 
belonging to the PM. 

/To illustrate the change of ownership, let's begin by the HSC issuing a BOOT_NORMAL 
command to a partition whose cmd_state field is set to READY indicating that the HSC 
has the ownership of the cmd field. Upon receiving the BOOT_NORMAL command from the 
HSC and on behalf of the HSC, the CSP writes the BOOT_NORMAL command byte to the cmd 
field of the structure for the partition. The PM reads and discovers a command being 

_f placed in the cmd field of the partition, then decides to instantiate the partition 
by changing the cmd_state from READY to BOOTING, thus causing the cmd field 
ownership to be switched from the HSC to the PM. The PM then clears the cmd field to 
acknowledge the consumption of the boot command, and sends a alert message to the 
CSP. The CSP detects the alert message of the change in the cmd_state field, and 

J then informs the HSC of the completion of the BOOT_NORMAL command request. If the 
partition fails to boot, the-err_code field is written with a failure code for the 
HSG— to—retrieve . The cmd_state field is then set to ERROR, thus switching the 
err^c.ojde field-.ownership from the PM to the HSC. The-HSC— can-examine^the^error^cqde , 
and. .try—to recover from the failure. Once— the-HSC— is— ready— to^ reboot— the— partition, 
/it requests the CSP to clear the err_code field, and place the boot command into cmd 
field again. T he PM sees the ,_err,_ code-being— cleared- and -a boot command^bei-ng 
presented, it then re-instantiates -the partition by changing the cmd— state from 
ERROR, to . BOOTING . 
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